#

| Chapter 2 UNIX Commands |

## cscope

    cscope [options] files

Interactive utility for finding code fragments in one or more C, lex, or yacc source `files`. cscope builds a symbol cross-reference (named cscope.out by default) and then calls up a menu. The menu prompts the user to search for functions, macros, variables, preprocessor directives, etc. Type ? to list interactive commands. Subsequent calls to cscope rebuild the cross-reference if needed (i.e., if filenames or file contents have changed). Source filenames can be stored in a file cscope.files. This file can then be specified instead of `files`. Options -I, -p, and -T are also recognized when placed in cscope.files.

### Options

-b

  Build the symbol cross-reference only.

-C

  Ignore uppercase/lowercase differences in searches.

-c

  Create output in ASCII (don't compress data).

-d

  Don't update the cross-reference.

-e

  Don't show the CTRL-E prompt between files.

-f `out`

  Name the cross-reference file `out` instead of cscope.out.

-I `dir`

  Search for include files in `dir` before searching the default (/usr/include). cscope searches the current directory, then `dir`, then the default.

-i `in`

  Check source files whose names are listed in `in` rather than in cscope.files.

-L

  Use with -`n pat` to do a single search.

-l

  Run in line mode; useful from within a screen editor.

-P `path`

  Use with -d to prepend `path` to filenames in existing cross-reference. This lets you run cscope without changing to directory where cross-reference was built.

-p `n`

  Show the last `n` parts of the filename path. Default is 1 (filename); use 0 to suppress the filename.

-s `dir`

  Look for source files in directory `dir` instead of in current directory.

-T

  Match only the first eight characters of C symbols.

-U

  Ignore file timestamps (assume no files changed).

-u

  Build cross-reference unconditionally (assume all files changed).

-V

  Print the cscope version on first line of screen.

-`n pat`

  Go to field `n` of input (starting at 0), then find `pat`.

Reference: crypt |  | Reference: csh